android开发学习之路

    由于和风天气返回的JSON数据结构非常复杂，我们借助GSON来对天气信息进行解析。

(一）定义GSON实体类

    GSON的用法比较简单。先将数据对应的实体类创建好。由于和风天气返回的数据非常多，作者筛选了一些比较重要的数据来进行解析。

    先回顾一下返回数据的大致格式：

    其中，basic、api、now、suggetion和daily_forecast的内部又都会有具体的内容，那么我们就可以将这5个部分定义成5个实体类。

    下面我们就可以将这5个部分定义成5个实体类。

    basic中具体内容如下所示：

    其中，city表示城市名，id表示城市对应的天气id，update中的loc表示天气的更新时间。我们按照此结构就可以在gson包下建立一个Basic类，代码如下：

   由于JSON中的一些字段可能不太适合直接作为Java字段来命名，因此这里使用了@SerializedName注解的方式来让JSON字段和Java字段之间建立映射关系。

   这样我们就将Basic类定义好了，其余的几个实体类也是类似的，我们使用同样的方式来定义。api中的具体内容如下:

    在gson包下新建一个AQI类，代码如下：

    now中的具体内容如下所示：

    在gson包下新建一个Now类，代码如下：

    suggestion中的具体内容如下所示：

    在gson包下新建一个Suggestion类，代码如下：

    到目前为止都还比较简单，不过接下来的一项数据就有点特殊了，daily_forecast中的具体内容如下所示：

     可以看到，daily_forecast中包含的是一个数组，数组中的每一项都代表着未来一天的天气信息。因此，我们需要定义单日天气的实体类，然后在声明实体类引用的时候使用集合类型来进行声明。

    在gson包下新建一个Forecast类，代码如下所示：

    这样我们就把basic、aqi、now、suggestion和daily_forecast对应的实体类全部都创建好了，接下来再创建一个总的实例类来引用刚刚创建的各种实体类。再gson包下新建一个weather类，代码如下：

    在Weather类中，我们对Basic、AQI、Now、Suggestion和Forecast类进行引用。其中由于daily_forecast中包含的是一个数组，因此用List集合来引用Forecas类。

    另外，返回的天气数据中还会包含一项status数据，成功返回ok，失败则会返回具体原因。

    现在所有GSON实体类都定义好饿，接下来开始编写天气界面。

（二）编写天气界面

    先创建一个用于显示天气信息的活动。右击com.coolweather.android包-New-Activity-Empty Activity,创建一个WeatherActivity，并将布局名指定成activity_weather.xml。

    由于所有的天气信息都将在同一个界面上显示，因此activity_weather.xml会是一个很长的布局文件。那么为了让里面的代码不至于那么混乱，这里使用引入布局技巧。即将界面的不同部分写在不同的布局文件里面，再通过引入布局的方式集成到activity_weather.xml中，这样整个布局文件就会显得非常工整。

    右击res/layout-New-Layout resource file，新建一个title.xml作为头布局，代码如下所示：

    这段代码在头布局中放置了两个TextView，一个居中显示城市名，一个居右显示更新时间。

    新建一个now.xml作为当前天气信息的布局，代码如下：

    当前天气信息的布局中放置两个TextView，一个用于显示当前气温，一个用于显示天气概况。

    新建forecast.xml作为未来几天天气信息的布局，代码如下：

    这里最外层使用LinearLayout定义了一个半透明的背景，然后使用TextView定义了一个标题，接着又使用一个Linearlayout定义了一个用于显示未来几天天气信息的布局。不过这个布局中并没有放入任何内容，因为这是要根据服务器返回的数据在代码中动态添加的。

    为此，我们还需要再定义一个未来天气信息的子项布局，创建forecast_item.xml文件，代码如下所示：

    子项布局中放置了4个TextView，一个用于显示天气预报，一个用于显示天气概况，另外两个分别用于显示当前的最高温度和最低温度。

    新建api.xml作为空气质量信息的布局，代码如下所示：

    这个布局看上去有点长，但很好理解。首先跟前面一样的，使用LinearLayout定义一个半透明的背景，然后使用TextView定义了一个标题。接下来，这里使用LinearLayout和RelativeLayout嵌套的方式实现了一个左右平分并且居中对齐的布局，分别用于显示AQI指数和PM2.5指数。

    新建suggestion.xml作为生活建议信息的布局，代码如下：

    这里同样也是定义了一个半透明的背景和一个标题，然后下面使用3个TextView分别用于显示舒适度、洗车指数、和运动建议的相关数据。

    这样我们就把天气界面上每个部分的布局文件都编写好了，接下来的工作就是将它们引入到activity_weather.xml当中，如下所示：

    可以看到，首先最外层布局使用了一个FrameLayout，并将它的背景色设置成colorPrimary。然后在FrameLayout中嵌套了一个ScrollView，这是因为天气界面中的内容比较多，使用ScrollWiew可以允许我们通过滚动的方式查看屏幕以外的内容。

    由于ScrollView的内部只允许存在一个直接子布局，因此这里又嵌套了一个垂直方向的LinearLayout，然后在LinearLayout中将刚才定义的布局逐个引入。

    这样，我们天气界面编写完成了，接下来编写业务逻辑，将天气显示到界面上。

（三）将天气显示到界面上

    首先在Utility类中添加一个用于解析天气JSON数据的方法，如下所示：

    可以看到，handleWeatherResponse（）方法中先是通过JSONObject和JSONArray将天气数据中的主题内容解析出来，即如下内容：

    由于我们之前已经按照上面的数据格式定义过相应的GSON实体类，因此只需要通过调用fromJson()方法就可以直接将JSON数据转换成Weather对象了。

    接下来的工作是我们如何在活动中去请求天气数据，以及将数据显示到界面上。修改WeatherActivity中的代码，如下所示：

    这个活动中的代码比较长，我们一步步梳理下。在onCreate()方法中先是去获取一些控件的实例，然后会尝试从本地缓存中读取天气数据。第一次是没有缓存的，因此会从Intent中取出天气id，并调用requestWeather()方法来从服务器请求天气数据。注意，请求数据的时候先将ScrollView进行隐藏，不然空数据的界面看上去会很奇怪。

    requestWeather()方法中先是使用了参数中传入的天气id，并调用requestWeather（）方法来从服务器请求天气数据。注意，请求数据的时候先将ScollView进行隐藏，不然空数据的界面看上去会很奇怪。

    requestWeather()方法中先是使用了参数中传入的天气id和我们之前申请好的APIKey拼装出一个接口地址，接着调用HttpUtil.sendOkHttpRequest()方法来向该地址发出请求，服务器会将相应城市的天气信息以JSON格式返回。然后我们在onResponse()回调中先调用Utility.handleWeatherResponse()方法将返回的JSON数据转换成Weather对象，再将当前线程切换到主线程。然后进行判断，如果服务器返回的status状态是ok，就说明请求成功了，此时将返回的数据缓存到SharedPreferences当中，并调用showWeatherInfo()方法来进行内容显示。

    showWeatherInfo()方法中的逻辑就比较简单了，其实就是从weather对象中获取数据，然后显示到相应的控件上。注意在未来几天天气预报的部分我们使用for循环来处理每天的天气信息，在循环中动态加载forecast_item.xml布局并设置相应的数据，然后添加到父布局当中。设置完了所有数据之后，记得要将ScrollView重新变成可见的。

    这样我们就将首次进入WeatherActivity时的逻辑全部梳理完了，那么当下一次再进入WeatherActivity时，由于缓存已经存在了，因此会直接解析并显示天气数据，而不会再次发起网络请求了。

    处理完了WeatherActivity中的逻辑，接下来我们要做的，就是如何从省市县列表界面跳转到天气界面了，修改ChooseAreaFragment中的代码，如下所示：

    这里在onItemClick()方法中加入了一个if判断，如果当前级别时LEVEL_COUNTY，就启动WeatherActivity，并把当前选中县的天气id传递过去。

    另外，我们还需要在MainActivity中加入一个缓存数据的判断才行。修改MainActivity中的代码，如下所示：

    可以看到，这里在onCreate()方法的一开始先从SharedPreferences文件中读取缓存数据，如果不为null就说明之前已经请求过天气数据了，那就直接跳转到WeatherActivity即可。

（四）获取必应每日一图

    现在我们已经把天气界面编写得不错了，不过和市场上的天气如见的界面相比还是又一定差距。出色的天气软件不会使用一个固定的背景色。因此我们添加更换背景的功能。这里我们使用一个巧妙的方法。

    必应时一个由微软开发的搜索引擎网站，它每天都会在首页展示一张精美的背景图片。如果我们使用它们来作为天气界面的背景图，不仅使界面更美观，而且解决一成不变的问题。

    为此，作者准备了一个获取必应每日一图的接口：http://guolin.tech/api/bing_pic。

    访问这个接口，服务器会返回今日的必应背景图连接：

    http://cn.bing.com/az/hprichbg/rb/ChicagoHarborLH_ZH-CN9974330969_1920x1080.jpg.

    然后我们再使用Glide去加载这张图片就可以了。

    首先修改activity_weather.xml中的代码，如下所示：

    这里我们在FrameLayout中添加了一个ImageView，并且将它的宽和高都设置成match_parent。由于FrameLayout默认情况下会将控件都放置在左上角，因此ScrollView会完全覆盖住ImageView，从而ImageView也就成为背景图片了。

    接着修改WeatherActivity中的代码，如下所示：

    可以看到，首先在onCreate()方法中获取了新增控件ImageView的实例，然后尝试从SharedPreferences中读取缓存的背景图片。如果有缓存的话就直接使用Glide来加载这张图片，如果没有的话就调用loadBingPic()方法去请求今日的必应背景图。

    loadBingPic()方法中的逻辑就非常简单了，先是调用了HttpUtil.sendOkHttpRequest()方法获取到必应背景图的连接，然后将这个链接缓存到SharedPreferences当中，再将当前线程切换到主线程，最后使用Glide来加载这张图片就可以了。另外需要注意，在requestWeather（）方法的最后也需要调用一下loadBingPic()方法，这样在每次请求天气信息的时候同时也会刷新背景图片。这样每天都会是不同的图片。

    不过这样背景图和状态栏没有融合到一起，这里我们使用一种简单的实现方式。修改WeatherActivity中的代码，如下所示：

    由于这个功能是Android5.0及以上的系统才支持的，因此我们先在代码中做了一个系统版本号的判断，只有当版本号大于或等于21，也就是5.0及以上系统时才会执行后面的代码。

    接着我们调用getWindow().getDecorView()方法拿到当前活动的DecorView，在调用它的setSystemUiVisibility()方法来改变系统UI的显示，这里传入View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN和View.SYSTEM_UI_FLAG_LAYOUT_STABLE就表示活动的布局会显示在状态栏上面，最后调用一下setStatusBarColor()方法将状态栏设置成透明色即可。但仅仅这些代码，天气界面的头布局几乎和系统状态栏紧贴到一起，这是由于系统状态栏已经成为我们布局的一部分，因此没有单独为它留出空间。当然这个问题也是非常好解决的。借助android:fitsSystemWindows属性就可以了。修改activity_weather.xml中的代码，如下所示：

     这里在ScrollView的LinearLayout中增加了android:fitsSystemWindows属性，设置成true就表示会为系统状态栏留出空间。

      下一章节开发手动更新天气和切换城市的功能。

具体实现步骤连接：

android开发学习之路——天气预报之技术分析与数据库（一）

android开发学习之路——天气预报之遍历省市县数据（二）

android开发学习之路——天气预报之显示天气信息（三）

android开发学习之路——天气预报之手动更新天气和切换城市（四）

android开发学习之路——天气预报之后台自动更新天气（五）